home *** CD-ROM | disk | FTP | other *** search
/ Popular Request / By Popular Request (Arsenal Computer)(SysOptics Distribution System).ISO / amiga4 / umsfi152.lha / Fido / UMSFido.dok < prev   
Text File  |  1993-11-19  |  14KB  |  376 lines
  1. Anleitung zu FidoExport 1.52 und FidoImport 1.52
  2. """"""""""""""""""""""""""""""""""""""""""""""""
  3.  
  4. Allgemeines
  5. ===========
  6.  
  7. Um   einen   Fido-Point  mit  UMS  zu  betreiben  braucht  man  FidoImport,
  8. FidoExport, TrapDoor und natⁿrlich UMS selbst und einen UMS-NewsReader.
  9.  
  10. FidoImport   dient   dazu,  Fido-Nachrichten,  die  vom  Programm  Trapdoor
  11. ⁿbertragen  wurden,  in  die UMS-Messagebase einzutragen.  Neu geschriebene
  12. Nachrichten  aus  der  Messagebase  werden  von  FidoExport  in  ein Format
  13. umgewandelt, das Trapdoor verschicken kann.
  14.  
  15. Den  Aufbau  dieser  sogenannten  Packet-Files  kann man der entsprechenden
  16. Fido-Literatur  (FSC-Files)  entnehmen.   Im  Handbuch  zu Trapdoor ist die
  17. Namensgebung der verschiendenen Files erklΣrt.
  18.  
  19.  
  20. Installation - Die Konfigurationsvariablen
  21. ==========================================
  22.  
  23. FidoImport   und   FidoExport   verden   ⁿber  Variablen  in  der  globalen
  24. Konfigurationsdatei   ums.config   konfiguriert.    Fⁿr  jedes  System  mit
  25. Fido-Technologie, mit dem man in Verbindug steht mu▀ man einen User-Eintrag
  26. erzeugen.   Dazu  mu▀  man die folgenden Konfigurationsvariablen ausfⁿllen.
  27. Ein (*) bedeutet, da▀ dieser Eintrag nicht angegeben werden mu▀.
  28.  
  29.  
  30.    fido.netname
  31.  
  32. Name  des Netzwerks mit "Fido Technology".  Wird als Identifikation fⁿr die
  33. zu   diesem   Netz   geh÷renden   Gruppen  ("netname.group")  und  Adressen
  34. ("z:n/f.p@netmane")  verwendet.   Im  Fidonet trΣgt man hier "fidonet" ein.
  35. Die  EintrΣge  "readaccess"  und "writeaccess" des zugeh÷rigen Users mⁿssen
  36. entsprechend gesetzt sein (z.B.  readaccess = "fidonet.#?").  Auch "export"
  37. sollte angepa▀t werden (z.B.  export = "#?@fidonet").
  38.  
  39.  
  40.    fido.pointaddress
  41.    fido.fakeaddress (*)
  42.    fido.stoneage (*)
  43.    fido.createINTL (*)
  44.  
  45. Die  Point-  bzw.   Fake-Adresse  beschreiben die eigene Fido-Adresse.  Die
  46. Fake-Adresse  mu▀  man  nur angeben, wenn die Software des Fido-Systems mit
  47. dem  man  komuniziert  keine 4D-Packets erzeugen und/oder verarbeiten kann.
  48. Gibt  man  bei  StonaAge "y" an, so erzeugt das eingene System auch nur 3-D
  49. Packets.   Bitte  vergessen  sie  nicht  pro  Adresse auch eine AKA Eintrag
  50. vorzunehmen.   Wenn man "createINTL" auf "y" setzt, dann erzeugt FidoExport
  51. bei  jeder  NetMail  den  INTL-Kludge.  Das verhindert Probleme mit mancher
  52. Software, wenn man mehrere Netze mit Fido-Technologie benutzt.
  53.  
  54.  
  55.    fido.bossaddress
  56.  
  57. Fido-Adresse der Boss-Node, bei der angerufen wird.
  58.  
  59.  
  60.    fido.mausgate (*)
  61.    fido.rfcgate (*)
  62.  
  63. Fido-Adressen   des   Maus-  bzw.   RFC-Gateways.   Diese  Adressen  werden
  64. ben÷tigt,  falls  Nachrichten  an  Maus-  oder  RFC-Adressen von FidoExport
  65. exportiert werden sollen.
  66.  
  67.  
  68.    fido.defaultorigin
  69.  
  70. Origin,  der  verwendet  wird,  falls  eine  Message noch keinen Origin vom
  71. NewsReader bekommen hat.
  72.  
  73.  
  74.    fido.inbound
  75.    fido.outbound
  76.    fido.tmpdir (*)
  77.  
  78. Pfade  (mit abschlie▀endem "/" oder ":") der Verzeichnissen fⁿr ankommende,
  79. abzuschickende und gerade bearbeitete Packets.
  80.  
  81.  
  82.    fido.arccmd
  83.    fido.dearccmd
  84.    fido.junkcmd
  85.  
  86. AmigaDOS-Kommandos  zum  Packen  bzw.   Entpacken von Packets.  Fⁿr defekte
  87. Packets  wird "junkcmd" aufgerufen.  Mit "%s" im Kommando kann bis zu 4 mal
  88. der Name des Packets eingefⁿgt werden.
  89.  
  90.  
  91.    fido.charset.xy (*)
  92.  
  93. FidoImport  kennt  ALLE in FSC 54 definierten Charsets.  Leider halten sich
  94. nicht  alle  Fido-User bzw -Programme an die Spezifikationen.  Deswegen ist
  95. ein 'alias' fⁿr Charsets vorgesehen.
  96.  
  97. Dem  nich  dem  Standard  entsprechenden  Charset ("xy") kann als Alias ein
  98. bekannstes  Charset  zugewiesen  werden.   Bekannt sind "LATIN-1", "IBMPC",
  99. "MAC"  fⁿr  8-Bit Sonderzeichen und "GERMAN", "FRENCH", "DUTCH", "FINNISH",
  100. "CANADIAN", "ITALIAN", "NORWEG", "PORTU", "SPANISH", "SWEDISH", "SWISS" und
  101. "UK"  fⁿr  7-Bit Sonderzeichen.  Alles andere entspricht nicht FSC 54, kann
  102. aber  mit  oben  beschriebener  Methode auf eine bekannte Tabelle umgelenkt
  103. werden.
  104.  
  105.  
  106.    fido.ascii (*)
  107.  
  108. Pattern  fⁿr  Gruppen  in die nur reine ASCII Nachrichten verschickt werden
  109. dⁿrfen.   FidoExport  wandelt  fⁿr diese Gruppen die Sonderzeichen in ASCII
  110. um.    In   allen   anderen   Gruppen  werden  die  Nachrichten  mit  allen
  111. Sonderzeichen und korrekter Charset-Kludge exportiert.
  112.  
  113.  
  114.    fido.security (*)
  115.  
  116. Dieser  String  enthΣlt beliebig viele Flags, die verschiedene Sicherheits-
  117. Stufen erm÷glichen.  Z. Zt.  sind folgende bekannt:
  118.  
  119.   PKTADR -     Packets nur dann importieren, wenn die Ziel-Addresse mit der
  120.                eigenen (4D- oder Fake-) Adresse ⁿbereinstimmt.
  121.  
  122.   PKTPWD -     bei einem Login ⁿber die Packet-Absender-Addresse mu▀ das im
  123.                Packet   enthaltene   Passwort  stimmen.   (Sonst  wird  bei
  124.                UMSLogin() auch "" als Passwort probiert).
  125.  
  126.   SESSIONPWD - ein  Login  (mit  Passwort  "")  ⁿber  die  Addresse aus dem
  127.                TrapDoor-Filenote  wird  nur  dann  durchgefⁿhrt,  wenn  die
  128.                ▄bertragung Passwort-geschⁿtzt war.
  129.  
  130. Mit PKTPWD und SESSIONPWD kann erreicht werden, da▀ nur authentisierte User
  131. Zugriff   auf  spezielle,  h÷her  privilegierte  UMS  User-Accounts  haben.
  132. Packets  von unbekannter oder nicht autentisierter Herkunft werden ⁿber den
  133. weniger privilegierten default-login eingetragen.
  134.  
  135. Diese  Sicherheits-Aspekte  sind  natⁿrlich  nur fⁿr Nodes interessant, die
  136. Passwort-geschⁿtze  ▄bertragungen mit bekannten Nodes und Points z.B.  auch
  137. bei Crash-Mail zulassen wollen.
  138.  
  139.  
  140.    fido.debuglevel (*)
  141.    fido.loglevel (*)
  142.    fido.reportlevel (*)
  143.    fido.reportuser (*)
  144.  
  145. FidoImport   und   FidoExport  erzeugen  3  verschiedene  Arten  Debug/Log-
  146. Information:    in   der   Standard-Ausgabe  (debuglevel),  im  UMS-Logfile
  147. (loglevel)  und  in einer Mail (report-level), die an einen beliebigen User
  148. (reportuser) verschickt wird.
  149.  
  150. Die  Level  sind  Σhnlich  gestaltet  wie die des UMS-Server:  kleine Werte
  151. bezeichnen  wichtige  Informationen oder schwere Fehler, gro▀e Werte stehen
  152. fⁿr weniger ausfⁿhrliche Informationen und leichtere Fehler.  0-4 bezeichen
  153. Fehler, 5-9 allgemeine Log-/Debug-Informationen.
  154.  
  155. Ein  "fido.debuglevel  =  9"  ergibt  z.B.  ausfⁿhrliche Informationen ⁿber
  156. jedes Packet, das bearbeitet wird.
  157.  
  158.  
  159.  
  160. Installation - Hinweise / Beispiel
  161. ==================================
  162.  
  163. Es   ist   sehr  praktisch,  da▀  bestimmte  EintrΣge  auch  lokal  zu  dem
  164. User-Eintrag   eines  Fido-Bosses  sein  k÷nnen.
  165.  
  166. Als Beispiel die relevanten Zeilen aus meiner ums.config:
  167.  
  168. -- cut --------------------------------------------------------------------
  169. fido.inbound            = "UMS:Inbound/"
  170. fido.outbound           = "UMS:Outbound/"
  171. fido.junkcmd            = "Copy %s UMS:Bad/ *n Delete %s"
  172. fido.defaultregion      = 2
  173. fido.mausgate           = "2:242/2.6"
  174. fido.rfcgate            = "2:242/6.1"
  175. fido.debuglevel         = 8
  176. fido.loglevel           = 6
  177. fido.reportlevel        = 5
  178. fido.reportuser         = SYSOP
  179. fido.charset.ISO-8859-1 = LATIN-1
  180. fido.ascii              = ~(fidonet.(AMIGA.GER|IBASE.POINTS|AMIPROG.GER|UMS.GER))
  181. fido.defaultorigin      = "Amiga Modula & Oberon Klub (AMOK) Stuttgart"
  182.  
  183. user
  184.   name              = Intuition-Base
  185.   alias             = fido.2.2407.106.0
  186.   alias             = fido.default
  187.   readaccess        = "fidonet.#?"
  188.   writeaccess       = "fidonet.#?"
  189.   import            = #?
  190.   export            = "(#?@fidonet|#?.maus)"
  191.   netaccess         = #?
  192.   distribution      = #?
  193.   fido.netname      = "fidonet"
  194.   fido.pointaddress = "2:2407/106.3"
  195.   fido.bossaddress  = "2:2407/106.0"
  196.   fido.arccmd       = "LhA -I -u -m -U2048 m %s %s"
  197.   fido.dearccmd     = "LhA -I -m -f -x0 -U8192 x %s %s"
  198. enduser
  199. -- cut --------------------------------------------------------------------
  200.  
  201. Jeder   User-Eintrag   eines   Fidosystems  sollte  einen  Alias  der  Form
  202. "fido.z.n.f.p" haben, damit FidoImport sich korrekt einloggen kann.
  203.  
  204. Der  User-Eintrag  des  Default-FidoBoss  bekommt  noch  die Zeile <alias =
  205. fido.default> verpa▀t.
  206.  
  207. <readaccess>   und   <writeaccess>   sollten   unbedingt  im  Einklang  mit
  208. <fido.netname> stehen.
  209.  
  210. <import> und <netaccess> sollten vorerst auf "#?" eingestellt bleiben.
  211.  
  212. Das  <export>  Pattern  sollte  man  sich gut ⁿberlegen.  Falls man nur bei
  213. Fido-Point ist, und nicht an UUCP und/oder Maus teilnimmt, genⁿgt ein "#?".
  214. Ansonsten  mu▀ man das Pattern so wΣhlen, da▀ es sich nicht mit den anderen
  215. Exportern   ⁿberschneidet,   aber  dennoch  Maus-  bzw.   UUCP-Mails  nicht
  216. ausschlie▀t,  falls  man  an dem jeweiligen Netz nicht direkt angeschlossen
  217. ist.   Ich bin z.B.  Fido- und UUCP-Point, deshalb habe ich mein Pattern so
  218. gewΣhlt,  da▀ Fido- und Maus-Mails von FidoExport exportiert werden k÷nnen.
  219. Die Maus-Mails werden automatisch an den Gateway geschickt.
  220.  
  221.  
  222. Pollen bei mehreren Fido-Systemen
  223. =================================
  224.  
  225. WΣre  ich  zusΣtzlich  noch Point (z.b.  Nr.  4711) bei der Mowgli, so wΣre
  226. zusΣtzlich noch dieser Usereintrag n÷tig:
  227.  
  228. -- cut --------------------------------------------------------------------
  229. user
  230.   name              = Mowgli
  231.   alias             = fido.2.242.7.0
  232.   readaccess        = %
  233.   writeaccess       = "fidonet.#?"
  234.   import            = #?
  235.   export            = %
  236.   netaccess         = #?
  237.   distribution      = #?
  238.   fido.netname      = "fidonet"
  239.   fido.pointaddress = "2:242/7.4711"
  240.   fido.fakeaddress  = "2:7000/4711"
  241.   fido.bossaddress  = "2:242/7.0"
  242.   fido.arccmd       = "LhA -0 -u -m -U2048 m %s %s"
  243.   fido.dearccmd     = "LhA -0 -m -f -x0 -U8192 x %s %s"
  244. enduser
  245. -- cut --------------------------------------------------------------------
  246.  
  247. Mit  Hilfe  der  <readaccess>-EintrΣge mⁿ▀te dann festgelegt werden, welche
  248. Areas   an   welche  Node  gehen.   Auch  beim  <export>-Pattern  ist  eine
  249. Unterscheidung  n÷tig!   Das  obige Bespiel konfiguriert die Mowgli nur so,
  250. da▀  ich von ihr empfangen kann.  Alle Mail und Echo-Mail wird weiterhin an
  251. die IntuitionBase geschickt.
  252.  
  253.  
  254. Teilnahme an anderen Netzen mit Fido-Technologie (z.B. GerNet)
  255. ==============================================================
  256.  
  257. Will  man z.B.  am GerNet teinehmen (zB.  wegen der CT.GER), so braucht man
  258. einen weiteren User-Eintrag, wie z.B.:
  259.  
  260. -- cut --------------------------------------------------------------------
  261. user
  262.   name              = GerNetBoss
  263.   alias             = fido.21.100.1202.0
  264.   readaccess        = "gernet.#?"
  265.   writeaccess       = "gernet.#?"
  266.   netaccess         = #?
  267.   import            = #?
  268.   export            = "#?@gernet"
  269.   distribution      = #?
  270.   priority          = -20
  271.   fido.netname      = "gernet"
  272.   fido.pointaddress = "21:100/1202.3"
  273.   fido.bossaddress  = "21:100/1202.0"
  274.   fido.arccmd       = "LhA -u -m -U2048 m %s %s"
  275.   fido.dearccmd     = "LhA -m -f -x0 -U8192 x %s %s"
  276. enduser
  277. -- cut --------------------------------------------------------------------
  278.  
  279.  
  280. Adressierung von Nachrichten
  281. ============================
  282.  
  283. Fido-Adressen werden von FidoImport/FidoExport in einem UMS-internen Format
  284. verarbeitet.    Deshalb   mu▀   man   anstatt  der  einfachen  Fido-Adresse
  285. ("2:123/4.5"),  die  Schreibweise  "2:123/4.5@fidonet"  ("@fidonet" ist ein
  286. Beispiel,  fⁿr  das der in der Konfiguration angegebene NetName einzusetzen
  287. ist)  verwendet  werden.   Nachrichten,  die falsch adressiert sind, k÷nnen
  288. nicht verschickt werden!
  289.  
  290.  
  291. Besondere FΣhigkeiten
  292. =====================
  293.  
  294. Um  Files  zu  verschicken (Fido-Fileattach) mu▀ man zum Attribute-Feld der
  295. Nachricht,   mit   der   das   File  verschickt  werden  soll,  den  String
  296. "file-attach"  hinzufⁿgen.   Das Subject der Nachricht gibt den Pfad zu dem
  297. File  an (z.B.  "Mail:Uploads/AttachMe.LHA").  Wenn man zusΣtzlich noch das
  298. Attribut  "delete"  angibt  wird  das File nach dem Verschicken automatisch
  299. gel÷scht.
  300.  
  301. Im  Fido  besteht  die  M÷glichkeit  pers÷nliche  Nachrichten direkt an den
  302. EmpfΣnger  (bzw.  dessen Boss) zu schicken.  Eine solche Crash-Mail erzeugt
  303. man, indem man das Attribute-Feld um den String "crash" erweitert.  Es wird
  304. dann im Outbound-Verzeichnis ein ".OUT"-File erzeugt.  Mit TrapDoor mu▀ man
  305. dann direkt bei dem EmpfΣnger anrufen.
  306.  
  307. Bei  Nachrichten,  die  von  Gateways  empfangen  wurde, wird versucht, den
  308. Absendernamen  und  die  Absender-Adresse  wieder in das original-Format zu
  309. wandeln.
  310.  
  311.  
  312. Aufruf von FidoImport
  313. =====================
  314.  
  315. Das Template von FidoImport ist:
  316.  
  317. NAME,PASSWORD,SERVER/K,INBOUND/K,PRESERVE/S
  318.  
  319. Der   Default-Login   ist   der  ⁿber  die  Command-Line  angegebene,  oder
  320. "fido-default", wenn die Command-Line leer war.
  321.  
  322. Wenn  m÷glich,  wird  aus der TrapDoor-Filenote fⁿr jedes Arcmail-Paket ein
  323. spezielle  Login  gewonnen.  Der Name der Users/Alias fⁿr die Fido-Addresse
  324. "z:n/f.p" lautet "fido.p.f.n.z".  Das Passwort ist "".
  325.  
  326. Weiterhin  wird  fⁿr  jedes  (3D-  oder 4D-) Packet versucht, ein Login aus
  327. Absenderaddresse des Packets zu gewinnen.  Das Format fⁿr den Namen ist das
  328. gleiche wie oben.  Das Passwort ist entweder das des Packets, oder "".
  329.  
  330.  
  331. Aufruf von FidoExport
  332. =====================
  333.  
  334. Das Template von FidoExport ist:
  335.  
  336.   USER,PASSWORD,SERVER/K
  337.  
  338. USER  und  PASSWORD  beziehen sich (natⁿrlich) auf den Usereintrag, der den
  339. Fido-Boss  reprΣsentiert.  Werden sie weggelassen, so loggt sich FidoExport
  340. als "fido.default" ohne Passwort ("") ein.
  341.  
  342. Zum  exportieren  fⁿr die Intuition-Base kann man jetzt einfach <FidoExport
  343. Intuition-Base    "">   oder,   falls   die   Intuition-Base   gleichzeitig
  344. "fido.default" ist, <FidoExport> schreiben.
  345.  
  346. TO DO:
  347. ======
  348.  
  349. - Fido-NodeSupport
  350. - Zusammenfⁿhrung von FidoImport und FidoExport
  351.  
  352. - FidoImport: Lokalisierung
  353.  
  354. - FidoExport: Bessere Log-Meldungen
  355. - FidoExport: herrenlose .PKT einpacken (4D Adresse testen)
  356. - FidoExport: automatisches Splitten von Messages
  357.  
  358.  
  359. Epilog:
  360. =======
  361.  
  362. Bugreports & VorschlΣge bitte in die UMS.GER oder direkt an mich!
  363.  
  364.  
  365. Viel Spa▀!
  366.  
  367. Kai Bolay
  368. Hoffmannstra▀e 168         E-Mail: UUCP: kai@amokle.stgt.sub.org
  369. 71229 Leonberg                     FIDO: 2:2407/106.3
  370. Telefon: 07152/24127
  371.  
  372. Martin Horneffer
  373. Warmweiherstra▀e 18        E-Mail: UUCP: mh@umshq.adsp.sub.org
  374. 52066 Aachen                       FIDO: 2:242/7.9
  375.                                    MAUS: AC.maus, AC2.maus
  376.